Skip to content

docs: README examples for pymat.search + Vis adapter methods#87

Open
gerchowl wants to merge 1 commit intomainfrom
feature/85-readme-3-3-examples
Open

docs: README examples for pymat.search + Vis adapter methods#87
gerchowl wants to merge 1 commit intomainfrom
feature/85-readme-3-3-examples

Conversation

@gerchowl
Copy link
Copy Markdown
Contributor

Summary

README was silent on the two features landed in 3.2.1 + 3.3.0. Add runnable examples via tests/test_readme_examples.py (auto-regenerates README.md).

Covers:

  • pymat.search() — fuzzy domain-library find (3.3.0). Examples for single-word, multi-token, grade match, and limit=.
  • Material.vis.to_threejs() / .to_gltf() — method-form adapter sugar (3.2.1). Example showing it alongside the module-level pymat.vis.to_gltf(m) equivalent.

Test plan

  • 24 README-example tests pass.
  • scripts/generate_readme.py emits the new sections into README.md.
  • README.md matches test_readme_examples.py pre-commit hook passes.

Adds two new sections (auto-generated from test_readme_examples.py):

- Finding Materials by Name — pymat.search(), multi-token queries,
  limit=, grade/parent matching (3.3.0 feature).
- Exporting Materials to Three.js / glTF / MaterialX — method form
  on Material.vis, module-level equivalent (3.2.1 feature).

Covers the features added in 3.2.1 + 3.3.0 that the README was
silent on. Tests double as doc and executable examples.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant